Skip to main content

Visualisierungselement: Frame

Symbol:

_visu_icon_symbol_frame.png

Kategorie: Basis

Das Element dient als Rahmen, um darin eine oder mehrere bereits bestehende Visualisierungen darzustellen. Sie erhalten eine strukturierte Benutzeroberfläche. Die Größe des Frames kann fest sein oder aber skaliert. Dann passt sich der Darstellungsbereich der referenzierten Visualisierung an die Framegröße an.

Elementeigenschaften

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Advanced oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften zur Verfügung.

Elementname

Beispiel: refVisUserInfo

Tipp

Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Elementtyp

Frame

Abschneiden

standard icon: Feste Größe. Dabei wird nur der Teil der referenzierten Visualisierung dargestellt, der in den Rahmen passt.

Voraussetzung: Eigenschaft Skalierungsart ist Unskaliert.

Rahmen anzeigen

. Darstellung des Frames
  • Kein Rahmen: Der Darstellungsbereich des Frames ist nicht eingerahmt.

  • Rahmen: Der Darstellungsbereich des Frames ist eingerahmt.

  • Kein Rahmen mit Offset: Der Darstellungsbereich des Frames ist nicht eingerahmt und der Darstellungsbereich der referenzierten Visualisierung ist im Vergleich zum Bereich des Frames um 1 Pixel nach innen verkleinert. Der Zwischenraum bewirkt, dass sich die referenzierte Visualisierung und die benachbarten Elementen nicht berühren.

Position

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Winkel

Voraussetzung: Diese Eigenschaft ist nur verfügbar, wenn Sie im Visualisierungmanager die Client-Animationen und Überlagerung systemeigener Elemente unterstützen Option gesetzt haben.

Wert für Winkel in Grad

Beispiel: 25

Anmerkung

Die Ansicht im Offlinebetrieb kann sich geringfügig von der Ansicht im Onlinebetrieb unterscheiden.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Sind alle Elementeigenschaften verfügbar?

Nur wenn Sie in der Eigenschaften die Option Advanced oder den Filter Alle Kategorien aktiviert haben, stehen Ihnen alle Eigenschaften zur Verfügung.

Tipp

Durch die Vergabe von eigenen Elementnamen werden die Elemente in der Elementliste schnell gefunden.

Skalierungsart

Skalierungsart 

Art und Weise, wie die Höhe und Breite der referenzierten Visualisierung skaliert wird

Die Visualisierung wird entweder in einem Frame oder einem Registerkarten-Element dargestellt.

Isotropisch 

Die Visualisierung wird auf die Größe des darstellenden Elements skaliert. Die Visualisierung behält dabei bei festem Verhältnis von Höhe zu Breite ihre Proportionen.

Anisotropisch 

Die Visualisierung wird auf die Größe des darstellenden Elements skaliert. Höhe und Breite werden unabhängig voneinander an das Element angepasst.

Unskaliert 

Die Visualisierung wird in Originalgröße dargestellt, ohne die Größe des darstellenden Elements zu berücksichtigen.

Scrollbar 

Die Visualisierung wird unskaliert im Element angezeigt. Wenn sie größer als das Element ist, wird das Element mit Scrollbalken versehen.

Hinweis: Weisen Sie den Eigenschaften Variable Scrollposition horizontal oder Variable Scrollposition vertikal Variablen zu. Sie können die Daten der Scrollbalkenposition dann in der Applikation verarbeiten.

Dynamisch scrollbar 

Die Größe der Visualisierung wird dynamisch und zyklisch berechnet. Bei der Berechnung der Größe wird die Sichtbarkeit der Elemente der referenzierten Visualisierung berücksichtigt. Die Scrollbalken werden nur dann angezeigt, wenn nach der dynamischen Berechnung nicht alle Inhalte der referenzierten Visualisierung im Bereich des Frames angezeigt werden können.

Deaktivieren des Hintergrundzeichnens

Deaktivieren des Hintergrundzeichnens

_cds_icon_option_deactivated.png: Die nicht animierten Elemente der referenzierten Visualisierung werden als Hintergrundbitmap (Hintergrund-Frame) gezeichnet, um die Performance der Visualisierung zu optimieren.

Vorteilhaft ist, dass Hintergrundelemente, wie beispielsweise farbige Rechtecke, einmalig im Hintergrund gezeichnet werden.

standard icon: Deaktiviert das Hintergrundzeichnen, um das oben beschriebene Verhalten zu vermeiden.

Problematisch kann es werden, wenn ein anderes Element (der Hauptseite) hinter diesem Hintergrund-Frame durchlaufen soll. In diesem seltenen Fall ist es sinnvoll, diese Option zu setzen, damit das Rechteck tatsächlich dahinter durchläuft.

Anmerkung

Für folgende Einstellungen ist die Eigenschaft verfügbar:

  • Funktionalität Client-Animation ist nicht aktiviert: Im Visualisierungsmanager, Registerkarte Einstellungenist die Option Client-Animation und Überlagerung systemeigener Elemente unterstützen nicht aktiviert.

    Bei aktivierter Client-Animation wird automatisch das Hintergrundzeichnen ausgeführt.

  • Eigenschaft Skalierungsart hat den Wert Scrollbar

Wischverhalten

Mit diesem Feature können die im Element (Frame oder Registerkarten) referenzierten Visualisierungen mittels Wischgeste (Pan- oder Flick-Geste) umgeschaltet werden.

Wischverhalten

Voraussetzung: Wischen ist nur möglich, wenn die Option Multitouch-Bedienung aktiviert ist.

Optionen, wie ein Visualisierungsbenutzer das Wischen (Pan- oder Flick-Geste) ausführen muss, um im Element einen Bildwechsel zur nächsten referenzierten Visualisierung auszulösen:

  • Horizontales Wischen: Wischen von rechts nach links, und umgekehrt

  • Vertikales Wischen: Wischen von oben nach unten, und umgekehrt

  • Nicht wischbar: Wischen ist deaktiviert (Default)

Tipp: Stellen Sie den Skalierungstyp auf Anisotropisch.

Wischvorschau

Voraussetzung: Die Option ist nur im Overlay-Betrieb (Option Client-Animation und Überlagerung systemeigener Elemente unterstützen) verfügbar, um die Vorschaubilder auf Multitouch-Geräten anzuzeigen.

_cds_icon_option_black_activated.png: Während der Wischgeste wird ein Vorschaubild der nächsten Visualisierung im Frame angezeigt.

Für weitere Informationen siehe: Visualisierungen referenzieren oder Einstellungen

Referenzierte Visualisierungen

Enthält die aktuell konfigurierten Visualisierungsreferenzen als Unterknoten.

Schaltfläche Konfigurieren

Öffnet den Dialog Konfiguration der Frame-Visualisierungen. Der Dialog ermöglicht die Verwaltung der referenzierten Visualisierungen.

Referenzierte Visualisierungen

Warnung

Visualisierungen können mit Hilfe von Frame-Elementen beliebig tief verschachtelt sein. Um den Frame-Auswahltyp Beliebige Visualisierung umschalten problemlos nutzen zu können, darf ein Frame jedoch nicht mehr als 21 referenzierte Visualisierungen enthalten. Sehen Sie hierzu auch die Beschreibung zur Eingabekonfiguration eines Elements: Aktion Framevisualisierung umschalten.

Liste der aktuell referenzierten Visualisierungen

Visualisierungen, die über eine Schnittstelle verfügen, haben diese als Unterknoten dargestellt. Dabei wird jede Schnittstellenvariable mit den aktuell zugewiesenen Übergabeparametern aufgelistet.

Beispiel:

. vis_FormA
  • iDataToDisplay_1 : PLC_PRG.iVar1

  • iDataToDisplay_2 : PLC_PRG.iVar2

Tipp

Sie können die Zuweisung der Variablen an eine Schnittstellenvariable hier ändern und das Wertefeld bearbeiten. Oder Sie klicken statt dessen auf die Schaltfläche Konfigurieren.

Position

Die Position definiert die Lage und Größe des Elements im Fenster der Visualisierung. Sie bezieht sich auf ein kartesisches Koordinatensystem. Der Ursprung liegt in der oberen linken Fensterecke. Die positive horizontale X-Achse verläuft nach rechts. Die positive vertikale Y-Achse verläuft nach unten.

X

X-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Y

Y-Koordinate (in Pixel) der linken oberen Ecke des Elements

Beispiel: 10

Breite

Angabe in Pixel

Beispiel: 150

Höhe

Angabe in Pixel

Beispiel: 30

Winkel

Voraussetzung: Diese Eigenschaft ist nur verfügbar, wenn Sie im Visualisierungmanager die Client-Animationen und Überlagerung systemeigener Elemente unterstützen Option gesetzt haben.

Wert für Winkel in Grad

Beispiel: 25

Anmerkung

Die Ansicht im Offlinebetrieb kann sich geringfügig von der Ansicht im Onlinebetrieb unterscheiden.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor die Symbole _visu_icon_position_element.png an eine andere Stelle ziehen.

Zentrum

Die Eigenschaften enthalten feste Werte für die Koordinaten des Rotationspunkts. Der Rotationspunkt ist im Editor als Symbol _visu_icon_center_point.png dargestellt und dient als Zentrum für die Rotation und die Skalierung.

Tipp

Die Werte können auch geändert werden, indem Sie im Editor das Symbol _visu_icon_center_point.png an eine andere Stelle ziehen.

X

X-Koordinate des Rotationspunkts

Y

Y-Koordinate des Rotationspunkts

Farben

Die Eigenschaften enthalten feste Werte für die Farben.

Farbe

Farbe des Rahmens

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben erscheint

_cds_icon_three_dots.png: Standarddialog Farbe öffnet sich für eine Farbauswahl

Anmerkung

Normalzustand ist, wenn die boolesche Variable in der Elementeigenschaft Farbvariablen nicht definiert ist oder ihr Wert FALSE ist.

Alarmfarbe

Farbe, mit der das Element während des Alarmzustands gefüllt ist

Anmerkung

Alarmzustand ist, wenn der Wert der booleschen Variable in der Elementeigenschaft Farbvariablen → Farbumschalg FALSE ist.

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0). Bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Farbe ist deckend.

0: Farbe ist voll transparent.

Anmerkung

Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Aussehen

Die Eigenschaften enthalten feste Werte um das Aussehen des Elements zu setzen.

Linienstärke

Wert in Pixel

Beispiel: 2

Anmerkung

Die Werte 0 und 1 führen beide zu einer Linienstärke von einem Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein.

Linienart

Art der Liniendarstellung

  • Durchgezogen

  • Striche

  • Punkte

  • Strich Punkt

  • Strich Punkt Punkt

  • Unsichtbar

Tipp

Unter der Eigenschaft Aussehensvariablen können Sie Variablen zuweisen, um das Aussehen dynamisch zu steuern. Dann werden die festen Werte hier überschrieben.

Texte

Text

Zeichenfolge (ohne einfache Anführungszeichen)

Beispiel: Main page %i

Das Element wird mit diesem Text beschriftet. Wenn im Text ein Platzhalter %<format string> angegeben ist, wird an der Stelle des Platzhalters der Wert der Variable in Eigenschaft Textvariable → Text ausgegeben.

Tipp

Mit dem Tastaturkürzel Strg + Eingabe fügen Sie einen Zeilenumbruch ein.

Tipp

Die eingegebenen Texte werden automatisch in die Textliste GlobalTextList übernommen. Somit können diese Texte lokalisiert werden.

Texteigenschaften

Die Eigenschaften erhalten feste Werte für die Texteigenschaften und wirken auf die Texte, die in Texte → Text oderTexte → Tooltip konfiguriert sind.

Horizontale Ausrichtung

Horizontale Ausrichtung des Texts innerhalb des Elements

Vertikale Ausrichtung

Vertikale Ausrichtung des Texts innerhalb des Elements

Textformat

. Definition, wie zu lange Texte dargestellt werden
  • Default: Zu langer Text wird abgeschnitten

  • Zeilenschaltung: Text wird in mehrere Zeilen umgebrochen

  • Auslassungspunkte: Der sichtbare Text endet mit „…“ und zeigt somit an, dass er nicht vollständig ist.

Schriftart

Beispiel: Standard

_cds_icon_three_dots.png: Dialog Schriftart öffnet sich

_cds_icon_arrow_down.png: Auswahlliste mit Stilschriftarten

Farbe Schriftart

Beispiel: Schwarz

_cds_icon_three_dots.png: Dialog Farbe öffnet sich

_cds_icon_arrow_down.png: Auswahlliste mit Stilfarben

Transparenz

Ganze Zahl (Wertebereich von 255 bis 0)

Der Transparenzwert bestimmt die Durchsichtigkeit der zugehörigen Farbe.

255: Farbe ist deckend

0: Farbe ist voll transparent

Anmerkung

Wenn die Farbe eine Stilfarbe ist und bereits einen Transparenzwert enthält, ist diese Eigenschaft schreibgeschützt.

Absolute Bewegung

Den Eigenschaften können IEC-Variablen zugewiesen werden, um die Position des Elements dynamisch zu steuern. Bezugspunkt ist die linke obere Ecke des Elements. Zur Laufzeit wird das Element als Ganzes bewegt.

Bewegung

X

  • Variable (numerischer Datentyp) für die X-Position (in Pixel)

    Beispiel: PLC_PRG.iPos_X

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach rechts.

Y

  • Variable (numerischer Datentyp) für die Y-Position (in Pixel)

    Beispiel: PLC_PRG.iPos_Y

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Ein Erhöhen des Werts zur Laufzeit führt zu einer Bewegung nach unten.

Rotation

Variable (numerischer Datentyp) für den Drehwinkel (in Grad)

Beispiel: PLC_PRG.iAngle1

Der Mittelpunkt des Elements rotiert um den Punkt in Zentrum. Dieser Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Zur Laufzeit bleibt die Ausrichtung des Elements in Bezug zum Koordinatensystem der Visualisierung erhalten. Ein Erhöhen des Werts führt zu einer Rechtsdrehung.

_visu_img_prp_rotation.png

Innere Rotation

Variable (numerischer Datentyp) für den Drehwinkel (in Grad)

Beispiel: PLC_PRG.iAngle2

Zur Laufzeit rotiert das Elements entsprechend dem Variablenwert um den Rotationspunkt in Zentrum. Zudem dreht die Ausrichtung des Elements bezüglich des Koordinatensystems der Visualisierung. Ein Erhöhen des Werts im Code bewirkt eine Rechtsdrehung.

Der Rotationspunkt wird im Editor als Symbol _visu_icon_center_point.png dargestellt.

Anmerkung

Wenn in der Eigenschaft Position → Winkel ein statischer Drehwinkel angegeben ist, wird bei der Visualisierungsausführung zum variablen Drehwinkel der statische Drehwinkel addiert (Offset).

_visu_img_prp_inner_rotation.png

Tipp

Sie können die Variablen mit einer Einheitenumrechnung kombinieren.

Tipp

Die Eigenschaften X, Y, Rotation und Innere Rotation werden von der Funktionalität „Client-Animation“ unterstützt.

Relative Bewegung

Die Eigenschaften enthalten Variablen, um das Element zu verschieben. Bezugspunkt ist die Position des Elements (Eigenschaft Position). Das Element kann dadurch seine Form ändern.

Bewegung oben links

X

  • Variable (Ganzzahliger Datentyp) für die Anzahl in Pixel, um die die linke Kante horizontal verschoben wird

    Beispiel : PLC_PRG.iDeltaX

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach rechts.

Y

  • Variable (Ganzzahliger Datentyp) für die Anzahl in Pixel, um die die obere Kante vertikal verschoben wird

    Beispiel : PLC_PRG.iDeltaY

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach unten.

Bewegung unten rechts

X

  • Variable (Ganzzahliger Datentyp) für die Anzahl der Pixel, um die die rechte Kante horizontal verschoben wird

    Beispiel : PLC_PRG.iDeltaWidth

  • Containervariable Container.Width

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach rechts.

Y

  • Variable (Ganzzahliger Datentyp) für die Anzahl der Pixel, um die die untere Kante vertikal verschoben wird

    Beispiel : PLC_PRG.iDeltaHeight

  • Containervariable Container.Height

    Für weitere Informationen siehe: Position und Größe optimal anpassen

Eine schrittweise Erhöhung des Werts führt zu einer Bewegung nach unten.

Textvariablen

Textvariable

Variable (Datentyp konform mit der Formatierungsangabe) für den Platzhalter in der Eigenschaft: Texte → Text

Beispiel: PLC_PRG.iAccesses

Der Variablenwert ersetzt den Platzhalter im Text des Elements. Zur Laufzeit wird das Element mit dem Text beschriftet, wobei der Variablenwert ständig aktualisiert wird.

Anmerkung

Wenn Sie hier eine Variable vom Typ einer textlistenunterstützten Enumeration angeben, wird automatisch hinter dem Variablennamen in spitzen Klammern der Name des Enumerationsdatentyps hinzugefügt. Beispiel: PLC_PRG.enVar <enumeration name>. Dann erscheint bei der Textausgabe anstelle des numerischen Werts der Enumerationskomponente der symbolische Wert. Sehen Sie hierzu die Hilfeseite zu Enumerationen.

Tooltipvariable

Variable (Datentyp konform mit der Formatierungsangabe) für den Platzhalter in der Eigenschaft: Texte → Tooltip

Beispiel: PLC_PRG.iAccessesInTooltip

Der Variablenwert ersetzt den Platzhalter im Tooltip des Elements. Zur Lauzeit wird der Tooltip ausgegeben, wobei der Variablenwert ständig aktualisiert wird.

Dynamische Texte

Dynamische Texte sind variabel indizierte Texte einer Textliste. Zur Laufzeit wird der Text ausgegeben, der aktuell in der Variablen indiziert ist.

Textliste

. Name der Textliste
  • Als Variable (STRING)

  • Als fester Stringliteral mit einfachen Anführungszeichen

    Beispiel: 'Errorlist'

_cds_icon_arrow_down.png: Auswahlliste mit den im Projekt verfügbaren Textlisten

Hinweis: Wenn eine Textliste aus dem Projekt an eine Visualisierung in einer Bibliothek übergeben wird, muss ein Punkt vor den Namen der Textliste angehängt werden.

Textindex

. Textlisten-ID, die auf den gewünschten Ausgabetext verweist
  • Als fester String mit der ID in einfachen Anführungszeichen

    Beispiel: '1'

  • Als Variable (STRING), um die Textausgabe dynamisch zu steuern

    Beispiel: strTextID

    Beispiel Zuweisung: PLC_PRG.strTextID := '1';

Tooltipindex

. Textlisten-ID, die auf den gewünschten Ausgabetext verweist
  • Als fester String mit der ID in einfachen Anführungszeichen

    Beispiel: '2'

  • Als Variable (STRING). um die Textausgabe dynamisch zu steuern

    Beispiel: strToolTipID

    Beispiel Zuweisung: PLC_PRG.strToolTipID := '2';

Schriftartvariablen

Die Variablen ermöglichen die Darstellung der Texte dynamisch zu steuern.

Schriftname

Variable (STRING) für die Schriftart des Textes

Beispiel: PLC_PRG.stFontVar := 'Arial';

Tipp

Welche Schriftarten zur Verfügung stehen, finden Sie im Standarddialog Schriftart.

Größe

Variable (Numerischer Datentyp) für die Schriftgröße in Pixel oder Punkten

Die verwendete Einheit ist hinter dem Variablennamen in spitzen Klammern angegeben.

  • <pt> : Punkte (Voreinstellung)

    Beispiel: PLC_PRG.iFontHeight <pt>

    Code: iFontHeight : INT := 12;

  • <px> : Pixel

    Beispiel: PLC_PRG.iFontHeight <px>

    Code: iFontHeight : INT := 19;

Tipp

Die Größe einer Schriftart ist in Punkten angegeben (Beispiel: Arial 12). Verwenden Sie die Einheit Punkte, wenn die variable Schriftgröße zu einer Schriftart passen soll, beispielsweise wenn in der Eigenschaft Texteigenschaft → Schriftart eine Schriftart eingestellt ist.

Tipp

Wenn Sie in das Wertefeld klicken, erscheint dort rechts die Auswahlliste _cds_img_dropdownlist_unit_font_size.png, mit der Sie die Einheit umstellen können.

Flags

Variable (DWORD) für die Flags, um die Schriftartdarstellung zu bestimmen

. Flags:
  • 1: Kursiv

  • 2: Fett

  • 4: Unterstrichen

  • 8: Durchgestrichen

Anmerkung

Sie können die Schriftartdarstellungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein fetter und unterstrichener Text: PLC_PRG.dwFontType := 6;

Zeichensatz

Variable (DWORD) für die Zeichensatznummer der Schriftart

Die Auswahl an Zeichensatznummern entspricht der Einstellung Skript des Standarddialogs Schriftart.

Farbe

Variable (DWORD) für die Farbe des Texts

Beispiel: PLC_PRG.dwColorFont:= 16#FF000000;

Flags für Textausrichtung

Variable (Ganzzahliger Datentyp) für die Codierung zur Textausrichtung

Beispiel: PLC_PRG.dwTextAlignment

. Codierung:
  • 0: Oben links

  • 1: Horizontal zentriert

  • 2: Rechts

  • 4: Vertikal zentriert

  • 8: Unten

Anmerkung

Sie können die Textausrichtungen kombinieren, indem Sie die Codierung der Flags addieren. Zum Beispiel ein vertikal und horizontal zentrierter Tex: PLC_PRG.dwFontType := 5;

Tipp

Feste Werte für die Darstellung der Texte sind in den Texteigenschaften gesetzt.

Farbvariablen

Die Elementeigenschaft wird als Schnittstelle für Projektvariablen verwendet, um zur Laufzeit Farben dynamisch zu steuern.

Farbumschlag

Variable (BOOL) für den Farbumschlag

. Wertebelegung:
  • FALSE: Element wird mit der in Eigenschaft Farbe angegebenen Farbdefinition dargestellt.

  • TRUE: Element wird mit der in Eigenschaft Alarmfarbe angegebenen Farbdefinition dargestellt.

. Belegung der Eigenschaft:
  • Platzhalter für die Benutzereingabevariable der Eingabekonfiguration

    • <Umschalten-/Tastenvariable>

    • <NOT Umschalten-/Tastenvariable>

    Dabei wird der Farbumschlag nicht mit einer eigenen Variablen gesteuert, sondern mit einer Benutzereingabevariable.

    Anmerkung

    Geben Sie in der Eingabekonfiguration für die Mausklickereignisse Umschalten oder Tasten eine Variable an, erst dann ist der Platzhalter gesetzt. Wenn sowohl in Umschalten als auch in Tasten eine Variable angegeben ist, wird die in Tasten angegebene Variable verwendet.

    Tipp

    Klicken Sie auf das Symbol _visu_icon_linked_variable.png, um den Platzhalter <Umschalten-/Tastenvariable> einzufügen.

    Wenn dabei die Eigenschaft Eingabekonfiguration, FALSE Tasten aktiviert ist, erscheint der Platzhalter <NOT Umschalten-/Tastenvariable>.

  • Instanzpfad einer Projektvariablen (BOOL)

    Beispiel: PLC_PRG.xColorIsToggeled

    Anmerkung

    Deklarieren und implementieren Sie im Code die hier angegebene Variable, deren Wertebelegung bestimmt, wann die Farbe umschlägt.

Farbe

Farbvariable für den Rahmen

  • Variable (DWORD) für die Farbe

    Beispiel: PLC_PRG.dwColor

  • Farbliteral

    Beispiel Grau, deckend: 16#FF888888

Voraussetzung: Eigenschaft Rahmen anzeigen ist aktiviert.

Anmerkung

Der Normalzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen → Farbumschlag nicht definiert ist oder den Wert FALSE hat.

Alarmfarbe

Farbvariable für den Rahmen im Alarmzustand

  • Variable (DWORD) für die Alarmfarbe

    Beispiel: PLC_PRG.dwAlarmColor

  • Farbliteral

    Beispiel Rot, deckend: 16#FFFF0000

Anmerkung

Der Alarmzustand ist gegeben, wenn der Ausdruck in der Eigenschaft Farbvariablen → Farbumschlag den Wert TRUE hat.

Tipp

Der Transparenzanteil des Farbwertes wird nur ausgewertet, wenn im Visualisierungmanager die Option Semitransparentes Zeichnen aktivieren aktiv ist.

Tipp

Aktivieren Sie in der Symbolleiste des Eigenschaften die Option Erweitert. Dann sind alle Elementeigenschaften sichtbar.

Aussehensvariablen

Die Eigenschaften enthalten Variablen, um das Aussehen des Elements dynamisch zu steuern.

Linienstärke

Variable (ganzzahliger Datentyp) für die Linienstärke in Pixel

Anmerkung

Die Werte 0 und 1 führen beide zu einer Linienstärke von einem Pixel. Wenn keine Linie dargestellt werden soll, muss die Eigenschaft Linienart auf die Option Unsichtbar gesetzt sein.

Linienart

Variable (DWORD) für die Linienart

. Codierung:
  • 0: Durchgezogene Linie

  • 1: Gestrichelte Linie

  • 2: Gepunktete Linie

  • 3: Liniendarstellung „Strich Punkt“

  • 4: Liniendarstellung „Strich Punkt Punkt“

  • 8: Unsichtbar: Die Linie wird nicht gezeichnet

Tipp

Unter der Eigenschaft Aussehen können feste Werte gesetzt sein, die zur Laufzeit von den dynamischen Variablen überschrieben werden.

Umschaltvariable

Variable

Die Variable steuert die Umschaltung der referenzierten Visualisierungen: Die Variable indiziert eine der referenzierten Framevisualisierungen und diese wird im Frame angezeigt. Wenn die Variable ihren Wert ändert, wird auf die neu indizierte Visualisierung umgeschaltet.

  • Variable (ganzzahliger Datentyp), die den Index der aktiven Visualisierung enthält

    Beispiel: PLC_PRG.uiIndexVisu

    Tipp

    Der Dialog Konfiguration der Framevisualisierung enthält die Liste der referenzierten Visualisierungen. Über die Reihenfolge in der Liste sind die Visualisierungen automatisch numerisch indiziert. Passen Sie die Reihenfolge der Framevisualisierungen an, um den gewünschten Index zu generieren.

    Anmerkung

    Diese Variante der Umschaltung wirkt sich üblicherweise auf alle verbundenen Darstellungsvarianten aus.

  • Arraykomponente (ganzzahliger Datentyp) für einen Indexzugriff über CURRENTCLIENTID

    Beispiel: PLC_PRG.aIndexVisu[CURRENTCLIENTID]

    Anmerkung

    Diese Variante der Umschaltung wirkt sich nur auf den aktuellen Client und somit nur auf eine Darstellungsvariante aus. Das ist die Darstellungsvariante, auf der die Werteänderung (beispielsweise über eine Benutzereingabe) ausgelöst wurde.

Zustandsvariablen

Die Variablen steuern dynamisch das Verhalten des Elements.

Unsichtbarkeit

Variable (BOOL) für das Umschalten der Sichtbarkeit des Elements

TRUE: Das Element ist zur Laufzeit nicht sichtbar.

Tipp

Die Eigenschaft Unsichtbarkeit wird von der Funktionalität „Client-Animation“ unterstützt.

Animation

Tipp

Diese Eigenschaften sind nur verfügbar, wenn Sie im Visualisierungmanager die Option Client-Animationen und Überlagerung systemeigener Elemente unterstützen aktiviert haben.

Animationsdauer

Vairable für die Dauer in Millisekunden, in der das Element eine Animation ausführt

  • Variable (Ganzzahliger Wert)

    Beispiel: Menu.tContent mit VAR tContent : INT := 500; END_VAR

  • Ganzzahliges Literal

    Beispiel: 500

. Animierbare Eigenschaften:
  • Absolute Bewegung, Bewegung, X, Y

  • Absolute Bewegung, Rotation

  • Absolute Bewegung, Innere Rotation

  • Absolute Bewegung, Äußere Rotation

Die animierte Bewegung wird ausgeführt, wenn mindestens ein Wert einer animierbaren Eigenschaft geändert wird. Die dann ausgeführte Bewegung ist nicht ruckartig, sondern wird reibungslos in der angegebenen Animationsdauer ausgeführt. Das Visualisierungselement fliegt die Sollposition an und rotiert dabei dynamisch. Die Übergänge sind fließend.

In den Vordergrund bringen

Variable (BOOL) für das Stellen des Elements in den Vordergrund

TRUE: Das Visualisierungselement wird zur Laufzeit im Vordergrund dargestellt.

FALSE: Das Visualisierungselement wird zur Laufzeit in der Ebene dargestellt, in der es im Visualisierungseditor eingefügt wurde.

Beispiel: bIsInForeground mit VAR bIsInForeground : BOOL := FALSE; END_VAR

Eingabekonfiguration

Die Eigenschaften enthalten die Konfigurationen für die Benutzereingabe bei Maus- oder Tastaturbedienung. Eine Benutzereingabe definiert ein Ereignis und eine oder mehrere Aktionen, die bei Eintreten des Ereignisses ausgeführt werden.

Tipp

Die Schaltfläche Konfigurieren öffnet den Dialog Eingabekonfiguration. Dort können Sie eine Benutzereingabe erstellen oder bearbeiten.

Unter den Ereignissen werden bereits konfigurierte Benutzereingaben aufgelistet. Sie enthalten jeweils die Aktion, die ausgelöst wird, und in knapper Form deren Einstellung.

Beispiel: ST-Code ausführen: _visu_icon_action.png PLC_PRG.i_x := 0;

OnDialogClosed

Eingabeereignis: Der Benutzer schließt einen Dialog.

OnMouseClick

Eingabeereignis: Der Benutzer führt im Elementbereich einen vollständigen Mausklick aus. Er drückt die Maustaste und gibt sie wieder frei.

OnMouseDown

Eingabeereignis: Der Benutzer drückt die Maustaste.

OnMouseEnter

Eingabeereignis: Der Benutzer zieht den Mauszeiger auf das Element

OnMouseLeave

Eingabeereignis: Der Benutzer zieht den Mauszeiger von einem Element weg

OnMouseMove

Eingabeereignis: Der Benutzer bewegt den Mauszeiger innerhalb des Elementbereichs

OnMouseUp

. Eingabeereignisse:
  • Der Benutzer gibt die Maustaste innerhalb des Elementbereichs frei. Dabei ist es unerheblich, ob der Benutzer vorher innerhalb oder außerhalb des Elementbereichs die Maustaste gedrückt hat.

  • Der Benutzer drückt die Maustaste innerhalb des Elementbereichs, verlässt den Elementbereich und gibt dann die Maustaste frei.

Anmerkung

Dieses CODESYS-spezifische Auslöseverhalten stellt bei Tastelementen das Beenden von Aktionen sicher. Ein Tastelement startet bei OnMouseDown eine Aktion, die bei OnMouseUp beendet wird.

Beispielsituation: Ein Visualisierungsbenutzer drückt die Maustaste innerhalb des Elementbereichs des Tastelements und verrutscht dann die Cursorposition so, dass diese außerhalb des Elementbereichs liegt. Die Aktion wird trotzdem beendet, da OnMouseUp auslöst.

OnValueChanged

Ereignis, das durch eine Wertänderung Folgeaktionen auslöst

Welche Folgeaktionen ausgelöst werden, wird im Dialog Eingabekonfiguration konfiguriert.

Die festgelegten Folgeaktionen und die jeweils dazugehörige Konfiguration werden unterhalb der Elementeigenschaft angezeigt.

Das Ereignis OnValueChanged kann durch das Compiler-Define VISU_NO_VALUECHANGED im Eigenschaftendialog der Applikation deaktiviert werden.

Tasten

Bei Auftreten eines Mausklickereignisses wird in der Applikation die unter Variable festgelegte Variable beschrieben. Die Codierung hängt von den Optionen FALSE Tasten und Beim Betreten tasten, falls Maus gefangen ab.

Variable

Voraussetzung: Die Option FALSE Tasten ist nicht aktiviert.

Variable (BOOL) für das Mausklickereignis

TRUE: Es liegt ein Mausklickereignis an. Es dauert solange ein Benutzer die Maustaste drückt, während er mit dem Mauszeiger das Element fokussiert. Es endet, wenn er die Taste freigibt.

FALSE: Es liegt kein Mausklickereignis an.

Beispiel: PLC_PRG.bIsTapped

FALSE Tasten

standard icon: Das Mausklickereignis führt zum komplementären Wert in Variable.

TRUE: Es liegt kein Mausklickereignis an.

FALSE: Solange das Mausklickereignis dauert.

Beim Betreten tasten, falls Maus gefangen

standard icon: Bei der Benutzereingabe wird zusätzlich berücksichtigt, ob bei gedrückter Maustaste der Mauszeiger innerhalb oder außerhalb des Elementbereichs gezogen wird.

TRUE: Solange das Mausklickereignis dauert und dabei der Mauszeiger innerhalb des Elementbereichs bewegt wird.

FALSE: Es liegt kein Mausklickereignis an. Oder aber der Benutzer bewegt den Mauszeiger bei gedrückter Maustaste außerhalb des Elementbereichs.

Sobald der Benutzer den Mauszeiger in den Elementbereich zurückbewegt, ist der Wert wieder TRUE. Man sagt, die „Maus ist gefangen“.

Umschalten

Bei Auftreten eines Mausklickereignisses wird die Variable gesetzt und bei Beenden des Mausklickereignisses zurückgesetzt.

Variable

Variable (BOOL) für das Umschalten beim Beenden des Mausklickereignisses

Das ist, wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger im Elementbereich ist. Wenn der Benutzer die Maustaste freigibt und dabei der Mauszeiger außerhalb des Elementbereich ist, liegt kein Beenden des Mausklickereignisses vor und der Wert wird nicht umgeschaltet.

Tipp

Der Benutzer kann damit eine begonnene Umschalteingabe abbrechen, indem er den Mauszeiger aus den Elementbereich zieht.

Umschalten beim Loslassen, falls Maus gefangen

standard icon: Der Wert schaltet um, unabhängig davon, wo der Mauszeiger beim Freigeben der Maustaste ist. Man sagt, die „Maus ist gefangen“.

Tastaturkürzel

Tastaturkürzel auf dem Element, um bestimmte Eingabeaktionen auszulösen

Bei Eintreten des Tastaturkürzel-Ereignisses werden die unter der Eigenschaft Ereignis(se) angegebenen Eingabeaktionen ausgelöst. Dabei ist nicht die Eingabeaktion selbst angegeben, sondern das Mauseingabeereignis, das auch zu dieser Eingabeaktion führt.

Taste

Taste, bei deren Drücken eine Eingabeaktion folgt.

Beispiel: T

Die folgenden Eigenschaften erscheinen, wenn eine Taste ausgewählt wird.

Ereignis(se)

  • Keine Aktion

  • MouseDown-Aktion: Ein Drücken der Taste lösen die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown konfiguriert sind.

  • MouseUp-Aktion: Ein Freilassen der Taste lösen die Eingabeaktionen aus, die in der Eigenschaft OnMouseUp konfiguriert sind.

  • MouseDown/MouseUp-Aktion: Ein Drücken und Loslassen der Taste lösen die Eingabeaktionen aus, die in der Eigenschaft OnMouseDown und OnMouseUp konfiguriert sind.

Umschalten

standard icon: Kombination mit Umschalttaste

Beispiel: Umschalt + T

Steuerung

standard icon: Kombination mit Steuerungstaste

Beispiel: Strg + T

Alt

standard icon: Kombination mit Alt-Taste

Beispiel: Alt + T

Tipp

In der Registerkarte Tastaturkonfiguration sind alle Tastaturkürzel und deren Folgeaktionen aufgelistet, die in der Visualisierung konfiguriert sind.

Zugriffsrechte

Anmerkung

Nur verfügbar, wenn eine Benutzerverwaltung für die Visualisierung eingerichtet ist.

Schaltfläche Zugriffsrechte

Öffnet den Dialog Zugriffsrechte. Dort können Sie die Zugriffsrechte für das Element ändern.

. Statusmeldungen:
  • Nicht gesetzt. Alle Rechte: Zugriffsrecht für alle Benutzergruppen: bedienbar

  • Rechte sind vergeben: eingeschränkte Rechte: Mindestens für eine Gruppe ist der Zugriff eingeschränkt